Spring Initializr Kullanımı: Proje Kur, İlk Endpoint'i Yaz (2026)

Spring Initializr Nedir?

Spring Initializr, Spring ekibi tarafından geliştirilen resmi proje başlatma aracıdır. start.spring.io adresinden ücretsiz kullanılır.

Sizin yerinize şunları yapar:

• Maven veya Gradle yapılandırmasını otomatik oluşturur
• Seçtiğiniz dependency'leri pom.xml'e ekler
• Standart Spring Boot klasör yapısını hazırlar
• Ana uygulama sınıfını (@SpringBootApplication) yazar

Yani sıfırdan yapmanız gereken onlarca adımı otomatikleştirir ve sizi asıl işe — kod yazmaya — odaklanmanızı sağlar.

Adım Adım Kullanım

start.spring.io'yu açın ve aşağıdaki seçimleri yapın:

1. Proje tipi ve dil

• Project: Maven — yeni başlayanlar için daha yaygın, daha fazla kaynak bulunur
• Language: Java
• Spring Boot: 3.x (en güncel stabil sürüm) — Spring Boot 2.x artık desteklenmiyor

2. Proje metadata

• Group: com.sirketadi — paket adınız, genellikle domain adınızın tersi
• Artifact: projeadi — oluşturulacak jar dosyasının adı
• Java: 21 — LTS sürümü, 2026 itibarıyla önerilen
• Packaging: Jar — web uygulaması için standart

3. Dependency ekleyin

Dependency seçimi projeye göre değişir. Bir sonraki bölümde hangi kombinasyonu seçmeniz gerektiğini açıklıyoruz.

4. Generate ve açın

"Generate" butonuna basın, zip dosyasını indirin ve açın. IntelliJ IDEA'da File → Open ile klasörü açın, pom.xml'i proje dosyası olarak tanıtın. Maven bağımlılıkları ilk açılışta otomatik indirilir — birkaç dakika sürebilir.

Hangi Dependency'leri Seçmeli?

Fazla dependency eklemeyin — gereksiz bağımlılıklar başlangıç süresini uzatır ve projeyi karmaşıklaştırır. Sonradan pom.xml'e her zaman eklenebilir.

Basit REST API için

• Spring Web
• Lombok

Veritabanı bağlantısı eklenecekse

• Spring Web
• Spring Data JPA
• PostgreSQL Driver veya MySQL Driver
• Lombok

Güvenlik de eklenecekse

• Spring Web
• Spring Data JPA
• Spring Security
• PostgreSQL Driver
• Lombok

Proje Yapısı Ne Anlama Geliyor?

Projeyi açtığınızda aşağıdaki klasör yapısını göreceksiniz:

src/
├── main/
│   ├── java/
│   │   └── com/sirketadi/projeadi/
│   │       └── ProjeadiApplication.java   ← Uygulamanın başladığı yer
│   └── resources/
│       ├── application.properties          ← Konfigürasyon dosyası
│       └── static/                         ← Statik dosyalar (CSS, JS)
└── test/
    └── java/                               ← Test sınıfları buraya
pom.xml                                     ← Dependency yönetimi

ProjeadiApplication.java içinde sadece şu kod bulunur:

@SpringBootApplication
public class ProjeadiApplication {
    public static void main(String[] args) {
        SpringApplication.run(ProjeadiApplication.class, args);
    }
}

Bu sınıfı çalıştırın — uygulama localhost:8080'de ayağa kalkar.

İlk REST Endpoint'inizi Yazın

Projeyi oluşturdunuz, şimdi ne yapacaksınız? Hemen çalışan bir endpoint yazalım.

src/main/java/com/sirketadi/projeadi/ altına yeni bir sınıf ekleyin:

@RestController
@RequestMapping("/api")
public class HelloController {

    @GetMapping("/hello")
    public String hello() {
        return "Merhaba, Spring Boot çalışıyor!";
    }
}

Uygulamayı çalıştırın ve tarayıcıdan http://localhost:8080/api/hello adresine gidin. "Merhaba, Spring Boot çalışıyor!" yazısını görmelisiniz.

application.properties Temel Ayarları

Veritabanı bağlantısı ekleyecekseniz src/main/resources/application.properties dosyasına şunları yazın:

# Sunucu portu (varsayılan 8080)
server.port=8080

# PostgreSQL bağlantısı
spring.datasource.url=jdbc:postgresql://localhost:5432/veritabaniadi
spring.datasource.username=kullanici
spring.datasource.password=sifre

# JPA ayarları
spring.jpa.hibernate.ddl-auto=update
spring.jpa.show-sql=true

IntelliJ IDEA İçinden Kullanım

start.spring.io'ya gitmeden IntelliJ IDEA içinden de proje oluşturabilirsiniz:

• File → New Project
• Sol menüden "Spring Boot" seçin
• Group, Artifact ve Java sürümünü doldurun
• Dependency'leri ekleyin
• "Create" — proje hazır

Sonuç start.spring.io ile birebir aynıdır, sadece tarayıcıya geçme adımını atlamış olursunuz.

Sık Sorulan Sorular

spring init --dependencies=web,jpa,security --java-version=21 myapp

Sonuç

Spring Initializr, Spring Boot projelerine hızlı ve doğru başlangıç yapmanın en güvenilir yoludur. Önemli olan sadece projeyi oluşturmak değil — klasör yapısını anlamak, doğru dependency'leri seçmek ve ilk endpoint'i çalıştırmak.

Projenizi oluşturduktan sonraki adım için Spring Boot ile RESTful servis geliştirme yazımıza göz atabilirsiniz.